The tgrind Style Option

It is useful to be able to include program fragments as figures in a text. The tgrind style option can be used to accomplish this fairly painlessly by defining the \tagrind command.

The \tagrind command has the following proforma:

\tagrind*[loc]{file}{caption }{label }

As usual,

• in two-column format, the ordinary form produces a single-column listing and the *-forms produces a double-column listing;

• loc is a sequence of one to four of the letters h (here), t (top), b (bottom) and p (page) specifying where the listing may be placed.

• file specifies the file from which the ground listing is to be taken.

• caption produces a numbered caption.

• label assigns a label to the listing, so that it may be referred to by means to the \ref{label} command.

The listing file should be generated using tgrind and removing the first and last lines of the resulting file. For example, if the C source file file.c were to be used as a listing,

     tgrind -f -lc file.c | sed -e 1d -e \$d >file.tex

\tagrind{file}{This is an example}{eg}